W02-1. Docker 기본 - 강의 노트
2주차 강의 노트: 이미지와 컨테이너 생명주기
- 컨테이너의 상태(생명주기) 와 상태를 바꾸는 명령어를 안다.
stop과kill의 차이, 그리고 "정상 종료" 가 왜 중요한지 안다.- "메인 프로세스가 끝나면 컨테이너도 끝난다" 는 규칙을 안다.
- 컨테이너 로그를 보는 법과 재시작 정책을 안다.
- 이미지의 전체 이름, 태그, 다이제스트, 멀티 플랫폼을 안다.
진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)
- 컨테이너 = 격리된 프로세스 (Namespace 로 보이는 범위를, cgroups 로 쓰는 양을 제한)
- 이미지 = 읽기 전용 설계도 → 컨테이너 = 실행된 상태
- 컨테이너를 지우면 안에서 바꾼 내용은 사라짐
1. 컨테이너의 일생: 생명주기
컨테이너는 만들어지고, 실행되고, 멈추고, 지워집니다. 각 상태와 상태를 바꾸는 명령어는 아래와 같습니다.
flowchart LR
I(["이미지"]) -- "docker create" --> C["Created
(만들어짐)"]
I -- "docker run
(= create + start)" --> R
C -- "docker start" --> R["Running
(실행 중)"]
R -- "docker pause" --> P["Paused
(얼림)"]
P -- "docker unpause" --> R
R -- "docker stop / kill
메인 프로세스 종료" --> E["Exited
(종료됨)"]
E -- "docker start" --> R
E -- "docker rm" --> X(["삭제"])
docker restart는 Running 상태에서 "stop → start" 를 한 번에 하는 명령입니다.
| 상태 | docker ps -a 의 STATUS |
뜻 |
|---|---|---|
| Created | Created |
만들어만 두고 아직 실행 안 함 |
| Running | Up 3 seconds |
실행 중 |
| Paused | Up 10 seconds (Paused) |
일시정지. 프로세스를 얼려 둔 상태. 메모리는 그대로지만 CPU 는 전혀 안 씀 |
| Exited | Exited (0) 5 seconds ago |
종료됨. 괄호 안 숫자는 종료 코드 |
| (삭제됨) | 목록에서 사라짐 | docker rm 으로 지운 상태 |
docker run = docker create + docker start
지난주에 쓴 docker run 은 만들기와 실행을 한 번에 하는 명령입니다. 이미지가 없으면 pull 까지 알아서 합니다.
멈춘(Exited) 컨테이너는 지우기 전까지 안의 변경 내용을 그대로 갖고 있습니다. docker start 로 다시 켤 수 있습니다.
그래서 docker ps -a 에 멈춘 컨테이너가 쌓이면 디스크를 차지합니다. 다 쓴 것은 docker rm 으로 지웁니다.
2. stop 과 kill: 정중하게 끄기 vs 플러그 뽑기
| 명령 | 하는 일 | 비유 |
|---|---|---|
docker stop |
① 메인 프로세스에 SIGTERM("이제 정리하고 끝내 주세요")을 보냄 ② 정해진 시간 동안 기다림 ③ 그래도 안 끝나면 SIGKILL(강제 종료) |
컴퓨터 시스템 종료 버튼 |
docker kill |
처음부터 SIGKILL 로 즉시 강제 종료 | 전원 플러그 뽑기 |
sequenceDiagram
participant D as Docker
participant P as 컨테이너 메인 프로세스
D->>P: SIGTERM (정리하고 종료해 주세요)
alt 프로세스가 신호를 처리함 (예: nginx)
P-->>D: 하던 요청 마무리 후 스스로 종료 → Exited (0)
else 신호를 무시함 (예: sleep)
Note over D: 대기 시간(-t) 만큼 기다림
D->>P: SIGKILL (강제 종료)
P-->>D: Exited (137)
end종료 코드 읽는 법
| 종료 코드 | 의미 |
|---|---|
0 |
정상 종료 |
1 등 작은 숫자 |
앱이 에러로 종료 |
137 |
SIGKILL 로 강제 종료됨 (128 + 9번 신호). 메모리 초과(OOM)로 죽었을 때도 137 |
143 |
SIGTERM 을 받고 종료됨 (128 + 15번 신호) |
웹 서버는 처리 중이던 요청을 마저 끝내야 하고, DB 는 메모리의 데이터를 디스크에 써야 합니다.
강제 종료(SIGKILL)를 당하면 요청이 끊기거나 데이터가 깨질 수 있습니다.
7주차 Kubernetes 무중단 배포도 결국 "컨테이너를 정중하게 끄고 새로 켜는 것"입니다.
- 리눅스 서버의 Docker Engine 기본값은 10초입니다.
- Docker Desktop 에서는 이보다 짧게 동작할 수 있습니다. 실습 노트북(4.93)에서는 약 3초였습니다.
- 그래서 실습에서는
docker stop -t 5처럼 시간을 직접 정해서 모두 같은 결과가 나오게 합니다. - 참고로 Kubernetes 의 기본 대기 시간은 30초입니다(10주차).
3. 핵심 규칙: 메인 프로세스가 끝나면 컨테이너도 끝난다
컨테이너는 메인 프로세스(PID 1) 하나를 위해 존재합니다. 메인 프로세스가 끝나는 순간 컨테이너도 Exited 가 됩니다.
| 실행한 것 | 메인 프로세스 | 결과 |
|---|---|---|
docker run -d alpine:3.24 echo hi |
echo hi |
글자 하나 찍고 끝 → 바로 Exited (0) |
docker run -d ubuntu:26.04 |
bash (입력 없음) |
할 일이 없어 끝 → 바로 Exited (0) |
docker run -d nginx:1.30-alpine |
nginx (계속 요청 대기) |
계속 Running |
docker run -d alpine:3.24 sleep 3600 |
sleep 3600 |
1시간 뒤 Exited |
"docker run -d ubuntu:26.04 했는데 컨테이너가 바로 꺼져요!"
→ 고장 난 게 아니라 할 일(메인 프로세스)이 없어서 끝난 것입니다.
컨테이너는 VM 처럼 "켜 두는 컴퓨터" 가 아니라 "프로그램 하나를 실행하는 상자" 입니다.
4. 로그: 컨테이너 앱은 화면에 출력한다
컨테이너 안의 앱은 로그를 파일 대신 표준 출력(stdout) / 표준 에러(stderr) 로 내보내는 것이 원칙입니다. Docker 가 이 출력을 모아 두었다가 docker logs 로 보여 줍니다.
flowchart LR
A["컨테이너 안의 앱
(nginx)"] -- "stdout / stderr" --> D["Docker Engine
(로그 저장)"]
D -- "docker logs" --> U["나 (터미널)"]
D -. "운영 환경에서는" .-> M["로그 수집 시스템
(10주차 맛보기)"]| 명령 | 하는 일 |
|---|---|
docker logs <이름> |
지금까지의 로그 전체 |
docker logs --tail 20 <이름> |
마지막 20줄만 |
docker logs -f <이름> |
실시간으로 계속 보기 (Ctrl + C 로 빠져나옴) |
docker logs -t <이름> |
줄마다 시간 표시 |
docker logs --since 10m <이름> |
최근 10분 로그만 |
nginx 는 원래 /var/log/nginx/access.log 파일에 로그를 씁니다. 공식 이미지는 이 파일을 표준 출력으로 연결해 두었습니다. 그래서 docker logs 로 접속 기록이 보입니다.
5. 재시작 정책: 죽으면 다시 살려 줄까?
docker run --restart <정책> 으로, 컨테이너가 멈췄을 때 Docker 가 자동으로 다시 켤지 정합니다.
| 정책 | 동작 | 언제 쓰나 |
|---|---|---|
no (기본값) |
다시 켜지 않음 | 실습, 일회성 작업 |
on-failure[:횟수] |
에러로 종료(코드 0이 아님)했을 때만 다시 켬 | 배치 작업 |
always |
어떤 이유로 멈춰도 다시 켬. Docker 가 재시작되면 같이 켜짐 | - |
unless-stopped |
always 와 같지만, 사람이 docker stop 으로 끈 것은 존중함 |
서버에 띄워 두는 서비스 (가장 많이 씀) |
재시작 정책은 "서버 한 대 안에서" 살려 주는 기능입니다.
서버 자체가 죽으면? 다른 서버에서 다시 띄워 줘야 합니다. 이것이 6주차부터 배울 Kubernetes 의 역할입니다.
6. 이미지 이름을 정확히 읽기
6-1. 전체 이름
우리가 nginx:1.30-alpine 이라고 짧게 쓰면, Docker 는 아래처럼 빈 부분을 기본값으로 채웁니다.
docker.io/library/nginx:1.30-alpine 을 네 부분으로 나누면:
| 부분 | 값 | 뜻 | 생략하면 |
|---|---|---|---|
| 레지스트리 | docker.io |
이미지 저장 서버 | Docker Hub (docker.io) |
| 계정(네임스페이스) | library |
누구의 이미지인지 | 공식 이미지(library) |
| 저장소(repository) | nginx |
이미지 이름 | 생략 불가 |
| 태그(tag) | 1.30-alpine |
버전 / 종류 | latest |
| 이렇게 쓰면 | 실제 이름 |
|---|---|
nginx |
docker.io/library/nginx:latest |
nginx:1.30-alpine |
docker.io/library/nginx:1.30-alpine |
내아이디/guestbook:v1 |
docker.io/내아이디/guestbook:v1 (4주차) |
ghcr.io/회사/앱:2.0 |
GitHub 의 레지스트리에 있는 이미지 |
6-2. 태그와 다이제스트
| 태그 (Tag) | 다이제스트 (Digest) | |
|---|---|---|
| 생김새 | 1.30-alpine |
sha256:0985e772fb9f... |
| 성격 | 사람이 붙이는 이름표. 다른 이미지로 옮겨 붙일 수 있음 | 이미지 내용으로 계산한 지문. 내용이 같으면 항상 같음 |
| 비유 | "최신판" 이라는 책 제목 | 책의 ISBN |
nginx:1.30-alpine 은 보안 패치가 나오면 같은 태그로 새 이미지가 다시 올라옵니다.
운영 환경에서 "절대 바뀌면 안 된다" 면 다이제스트로 고정합니다(nginx@sha256:...). 이 스터디에서는 버전 태그로 충분합니다.
6-3. 멀티 플랫폼 이미지: 태그 하나에 CPU 별 이미지 여러 개
지난주에 Windows 는 x86_64, Apple Silicon Mac 은 aarch64 가 나왔습니다. 그런데 모두 같은 이름 alpine:3.24 를 받았습니다. 어떻게 된 걸까요?
flowchart LR
T["nginx:1.30-alpine
(이미지 인덱스)"] --> A["linux/amd64 용
→ Windows, Intel Mac"]
T --> B["linux/arm64 용
→ Apple Silicon Mac"]
T --> C["linux/arm/v7, s390x 등
기타 CPU 용"]- 공식 이미지의 태그 하나에는 CPU 종류별 이미지가 여러 개 들어 있습니다(이미지 인덱스).
docker pull하면 Docker 가 내 CPU 에 맞는 것을 자동으로 골라 받습니다.- 4주차에 우리가 만드는 이미지도 이렇게 amd64 + arm64 를 함께 만들어 올릴 것입니다.
6-4. 레이어: 이미지는 여러 층으로 되어 있다 (맛보기)
docker pull 할 때 여러 줄이 동시에 내려받아지는 것을 보셨나요? 줄 하나하나가 레이어(층) 입니다.
3d85d110b167: Pull complete ← 레이어 1
22e5a8a110ec: Pull complete ← 레이어 2
703c5424632f: Pull complete ← 레이어 3
...
- 이미지는 변경 사항을 층층이 쌓은 것입니다(OS 파일 → 프로그램 설치 → 설정…).
- 여러 이미지가 같은 층을 쓰면 한 번만 받고 한 번만 저장합니다.
- 자세한 원리와 직접 쌓아 보는 실습은 4주차 Dockerfile 에서 합니다.
7. 정리 명령어와 주의 사항
| 명령 | 하는 일 |
|---|---|
docker rm <이름> |
멈춘 컨테이너 삭제 (실행 중이면 -f) |
docker image rm <이미지> |
이미지 삭제 (그 이미지를 쓰는 컨테이너가 있으면 거부됨) |
docker system df |
이미지 / 컨테이너 / 볼륨이 디스크를 얼마나 쓰는지 |
prune 명령은 조심하세요
docker container prune, docker system prune 은 멈춘 컨테이너, 안 쓰는 이미지 등을 한꺼번에 지웁니다.
다른 업무용 컨테이너가 있는 노트북이라면 필요한 것까지 지워질 수 있습니다.
이 스터디에서는 이름을 지정해서(study-…) 지우는 습관을 들입니다.
핵심 요약
2주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① 생명주기 Created → Running ⇄ Paused → Exited → (rm) 삭제
docker run = create + start (+ 필요하면 pull)
② 끄는 법 stop = SIGTERM → 기다림 → SIGKILL (정중하게)
kill = 바로 SIGKILL (강제)
종료 코드 0 = 정상 / 137 = 강제 종료
③ 핵심 규칙 메인 프로세스(PID 1)가 끝나면 컨테이너도 끝난다
④ 로그 앱은 stdout/stderr 로 출력 → docker logs [-f] [--tail N]
⑤ 재시작 --restart unless-stopped : 죽으면 다시 켜되, 사람이 끈 건 존중
⑥ 이미지 docker.io/library/nginx:1.30-alpine
태그 = 이름표(바뀔 수 있음) / 다이제스트 = 지문(불변)
태그 하나에 CPU 별 이미지 여러 개 (멀티 플랫폼)
참고 자료
더 깊이 보고 싶다면 (볼트 내 정리 노트):
공식 문서:
- docker container stop: https://docs.docker.com/reference/cli/docker/container/stop/
- 재시작 정책: https://docs.docker.com/engine/containers/start-containers-automatically/